home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / ava.zip / AVA.DOC < prev    next >
Text File  |  1989-05-01  |  14KB  |  397 lines
  1.  
  2.  
  3.  
  4.                         Automated Verification Algorithm
  5.                    A true callback verification door for QBBS 
  6.                              (c) 1989 by Cat Miller
  7.  
  8.  
  9.                          This program is supported by:
  10.                                   Cat Miller
  11.                             Off-The-Wall Programming
  12.                         13610 N. Scottsdale RD. STE 146
  13.                            Scottsdale, Arizona 85254
  14.     
  15.  
  16.     
  17.     A.V.A. which is an acronym for Automated Verification Algorithm is
  18.     a SysOp utility which will call back and automatically verify a bbs
  19.     user.
  20.  
  21.     The following files were included in the .ZIP archive:
  22.  
  23.         AVA.Exe..............................The Main Program
  24.         AVA.Doc..............................This documention text file
  25.         AVA.Cfg..............................A sample configuration file
  26.     
  27.  
  28.     To run A.V.A. you must use a TYPE 15 menu command and set an errorlevel.
  29.     Please refer to your QBBS documentation regarding menu setup.  The
  30.     main program, the configuration file and Instruct.Txt must all be in
  31.     the same directory.  It is prefered that you place AVA.Exe and 
  32.     accompanying files in your  QBBS root directory.  This is because 
  33.     A.V.A. utilizes PhoneDupe.Log and Phonenum.Ctl.  Please refer to the 
  34.     QBBS documentation regarding these two files QBBS.  However, if you do 
  35.     place AVA in its own directory then you must ensure that EXITINFO.BBS, 
  36.     DORINFO1.DEF, PhoneDupe.Log and Phonenum.Ctl are copied into that 
  37.     directory.  You must also copy those files back into the QBBS main 
  38.     directory before loading QuickBBS.  QuickBBS uses the information 
  39.     stored in EXITINFO.BBS to reinstate itself. 
  40.  
  41.  
  42.     Batch File
  43.     ----------
  44.  
  45.     To add AVA to your QBBS batch file you must set an ErrorLevel with 
  46.     your TYPE 15 menu option.  Here is an example of a batch file:
  47.  
  48.     Echo Off
  49.     Cls
  50.     Echo ***** Loading QBBS Now *****
  51.  
  52.     :Start
  53.     QuickBBS
  54.  
  55.     :After_Quick
  56.     If ErrorLevel 10 Goto AVA
  57.     If ErrorLevel 2 Goto RightHere
  58.     If ErrorLevel 1 Goto Somewhere
  59.     If ErrorLevel 0 Goto Quote
  60.  
  61.     :AVA
  62.     AVA AVA.Cfg
  63.     Goto Restart
  64.  
  65.     :RightHere
  66.     REM Doing something here
  67.  
  68.     :Somewhere
  69.     REM Do something else here
  70.  
  71.     :Quote
  72.     Ezquoted Quote.Cfg
  73.     Copy GoodBye.Asc+HitEnter.Asc
  74.     Copy GoodBye.Asc F:
  75.     Goto Start
  76.  
  77.     :Restart
  78.     QuickBBS -r
  79.     Goto After_Quick
  80.     
  81.  
  82.     The above is a crude example.  But you see that on an ErrorLevel 10 
  83.     the batch file jumps to the label AVA and runs A.V.A.  When A.V.A. is 
  84.     completed the batch file jumps to the label Restart to reinstate the 
  85.     bbs. 
  86.  
  87.     The following example shows what to expect if you place A.V.A. in its 
  88.     own directory.
  89.     
  90.     :AVA
  91.     cd c:\qbbs\Ava
  92.     Copy c:\qbbs\exitinfo.BBS
  93.     Copy c:\qbbs\dorinfo1.def
  94.     Copy c:\qbbs\phone*.*
  95.     AVA AVA.CFG
  96.     cd c:\qbbs
  97.     copy c:\qbbs\ava\exitinfo.bbs
  98.     copy c:\qbbs\ava\phone*.*
  99.     goto Restart
  100.  
  101.     Whew!  What a pain and it would cause somewhat of a lull if set up 
  102.     this way.  But, this is just an example.
  103.  
  104.  
  105.     A.V.A. Configuration file       
  106.     -------------------------
  107.  
  108.     A.V.A. requires a configuration file.  The configuration file contains
  109.     information that A.V.A. will use during the course of verifying a 
  110.     user.  The syntax to invoke A.V.A. is as follows:
  111.  
  112.                 d:\> AVA AVA.Cfg
  113.  
  114.     The configuration file consists of 13 lines and can be created with 
  115.     your favorite word processor.  Here is an explanation for each line. 
  116.  
  117.     Line 1:
  118.     
  119.     Place the name of your BBS here.
  120.  
  121.     Line 2:
  122.  
  123.     This line tells A.V.A. whether or not to allow long distance or toll 
  124.     calling. 
  125.  
  126.     Place a no here if you do not wish to run up your phone bill or place
  127.     a yes here to support this option.
  128.  
  129.     Line 3:
  130.  
  131.     Place a no here if you do not wish to grant minimum access or yes if 
  132.     you do.
  133.  
  134.     * Note *
  135.          If Line 2 is set to no then A.V.A. will look at line 3 and 
  136.     act accordinly.
  137.  
  138.     Line 4:
  139.  
  140.     This line contains the security level granted to callers who 
  141.     completed verification.
  142.  
  143.     Line 5:
  144.  
  145.     This line contains the download bytes granted after verification 
  146.     has been completed.
  147.  
  148.     * Note *
  149.          The download byte should match what you have defined in your 
  150.          Limits.Ctl file.
  151.  
  152.     Line 6:
  153.  
  154.     This line contains the time limit granted after verification has 
  155.     been completed.
  156.  
  157.     * Note *
  158.          The time lime should match what you have defined in your 
  159.          Limits.Ctl file.
  160.  
  161.     Line 7:
  162.  
  163.     This is the minimum security level granted to long distance or toll
  164.     callers.
  165.  
  166.     This feature is active only if Line 3 is yes.  However, it must still 
  167.     be defined even if you do not support minimum access.  A numeric value 
  168.     is expected here.
  169.  
  170.     Line 8:
  171.  
  172.     This is the minimum download byte granted to long distance or toll 
  173.     callers.
  174.  
  175.     This feature is active only if Line 3 is yes.  However, it must still 
  176.     be defined even if you do not support minimum access.  A numeric value 
  177.     is expected here.
  178.     
  179.     * Note * 
  180.          The download byte should match what you have defined in your 
  181.          Limits.Ctl file.
  182.  
  183.     Line 9:
  184.  
  185.     This is the minimum daily time limit granted to long distance or toll 
  186.     callers.
  187.  
  188.     This feature is active only if Line 3 is yes.  However, it still must 
  189.     be defined even if you do not support minimum access.  The daily time 
  190.     limit is expressed in minutes.
  191.  
  192.     * Note *
  193.           The time limit should match what you have defined in your 
  194.           Limits.Ctl file.
  195.  
  196.     Line 10:
  197.  
  198.     Place your area code here
  199.  
  200.     Line 11:
  201.  
  202.     If you want to allow callers to edit their phone numbers before 
  203.     verification can begin then put a yes here.
  204.  
  205.     Place a no here if you do not want to support this option.
  206.  
  207.     Line 12:
  208.  
  209.     Place a yes here to allow duplicate phone numbers or no to not allow 
  210.     duplicate phone numbers.
  211.  
  212.     Line 13:
  213.  
  214.     Place the SysOp's security level here.  This is so the SysOp will be 
  215.     able to access A.V.A. for whatever reason.
  216.  
  217.  
  218.     Sample configuration file:
  219.  
  220.     The Alternate Choice      <--- BBS Name
  221.     no                        <--- Long distance or toll calls not allowed
  222.     yes                       <--- Grant minimum access to ld callers
  223.     20                        <--- Verified security level
  224.     720                       <--- Verified download bytes
  225.     45                        <--- Verified time limit per day
  226.     10                        <--- Minimum access level
  227.     320                       <--- Minimum access download bytes
  228.     35                        <--- Minimum access time limit per day
  229.     602                       <--- My area code
  230.     no                        <--- Editing/changing numbers not allowed
  231.     no                        <--- Duplicate phone numbers are not allowed
  232.     100                       <--- SysOp's security level
  233.  
  234.  
  235.     *  I must state here that the configuration file consists of thirteen 
  236.     lines.  A.V.A. expects to find data in every line. *
  237.  
  238.  
  239.     What you the SysOp can expect from A.V.A.
  240.     -----------------------------------------
  241.     
  242.     When a new caller uses AVA he will be presented with a screen of 
  243.     information.  This information explains what he can expect from AVA 
  244.     and what AVA expects from him.  His option here is to proceed with the 
  245.     verification or return to the BBS.
  246.  
  247.     The options available to the SysOp are:
  248.  
  249.     [F6] Twit                 <--- Disconnect the caller completely
  250.     [F7] DOS                  <--- Shell to DOS
  251.     [F8] Return caller to bbs <--- Take caller out of the door
  252.     [F9] Display On/Off       <--- Active only while the door is running
  253.     [F10] Chat                <--- SysOp chat with caller
  254.     
  255.  
  256.     AVA retrieves the phone number(s) and caller's password from
  257.     EXITINFO.BBS.  If you have elected to as